home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 21 / CU Amiga Magazine's Super CD-ROM 21 (1998)(EMAP Images)(GB)[!][issue 1998-04].iso / CUCD / Utilities / DTConvert / DTConvert.doc < prev    next >
Text File  |  1998-02-05  |  5KB  |  149 lines
  1. DTConvert/DTConvert                                       DTConvert/DTConvert
  2.  
  3.     NAME
  4.        DTConvert -- DataTypes-based conversion tool
  5.  
  6.     FORMAT
  7.        DTConvert [FROM|NAME|SRCNAME <file>]
  8.                  [DESTDATATYPE|DATATYPE|DTN <datatype>] [IFF]
  9.                  [TO|DESTNAME <file>] [GUI] [PUBSCREEN <public screen>]
  10.  
  11.     TEMPLATE
  12.        FROM=NAME=SRCNAME,DESTDATATYPE=DATATYPE=DTN,IFF/S,TO=DESTNAME,
  13.        GUI/S,PUBSCREEN/K
  14.  
  15.     PURPOSE
  16.        Convert data from one format into another format using datatypes
  17.        classes.
  18.  
  19.     DESCRIPTION
  20.        DTConvert converts data from one format into another format,
  21.        e.g. picture -> picture,
  22.             animation -> anmation,
  23.             movie -> movie,
  24.             sound -> sound,
  25.             text -> text (n/a)
  26.  
  27.       You simply have to set the souce file name (SRCNAME), the
  28.       datatype to convert to (DATATYPE) (or the IFF switch if you want to
  29.       convert into the base-IFF format and the destination file name (TO).
  30.  
  31.     BUGS
  32.       - picture.datatype V43 interface not implemented.
  33.         This causes that any encoder only runs in V42 mode any may
  34.         only encode 8 bit data.
  35.  
  36.       - path names are limitted to 1024 chars, larger filenames may cause
  37.         mailfunctions
  38.  
  39.     NOTES
  40.       - picture.datatype V43 pixmap interface not supported.
  41.  
  42.       - text conversion not supported yet.
  43.  
  44.     TODO
  45.       - picture.datatype V43 compatibility
  46.  
  47.       - text conversion
  48.  
  49.       - GUI and WB suppport
  50.  
  51.     HISTORY
  52.        V1.1:
  53.          - First release to dta@amigawolrd.com mailinglist.
  54.  
  55.        V1.2:
  56.          - Added support for animation.datatype subclasses
  57.  
  58.        V1.3:
  59.          - Minor fixes.
  60.  
  61.        V1.4
  62.          - Added support for sound.datatype V40 subclasses, partial support
  63.            for suggested sound.datatype V41 interface.
  64.  
  65.          - Added some usefull comments.
  66.  
  67.          - WriteAnimClass/WriteSoundClass now sets
  68.            SetIoErr( ERROR_REQUIRED_ARGUMENT_MISSING ); if something goes
  69.            wrong (this should abort the encoder; only ERROR_OBJECT_NOT_FOUND
  70.            is accepted here).
  71.  
  72.          - Fixed some holes in the error handling.
  73.  
  74.          - GUI added.
  75.  
  76.          - Added WB support
  77.  
  78.          - Added ENV variable support; a local or global (ENV) variable
  79.            "DTConvert" takes the same arguments as the shell template.
  80.            Variable settings can be overridden by any argument.
  81.  
  82.          - Project split in seperate sources (e.g. main, GUI, converters)
  83.  
  84.        V1.5
  85.          - Added the feature that the datatypes selection requester shows
  86.            only entries which match the source group IDs
  87.            (if a source has been already selected).
  88.  
  89.          - Added kluge which alows the conversion between GID_MOVIE
  90.            and GID_ANIMATION datatypes (both are based on
  91.            animation.datatype, here we have the same interface :-)
  92.  
  93.          - Fixed the bug that ConvertAnimation function did not deal
  94.            with truecolor bitmaps (e.g. CyberGFX bitmaps for example,
  95.            truecolor bitmaps are indicated by ADTA_NumColors == 0.
  96.            Fixed.
  97.  
  98.        V1.6
  99.          - Fixed the bug that ObtainDataTypeA was called for each
  100.            INTUITICK if the datatype selection requester was open.
  101.            Fixed.
  102.  
  103.  
  104.     AUTHOR's REQUEST
  105.         By  releasing  this program I do  not  place any obligations on you,
  106.         feel free to share this program with your  friends (and enemies).
  107.  
  108.         If you want to blame me, report any bugs, or wants a new version
  109.         send your letter to:
  110.                         Roland Mainz
  111.                         Hohenstaufenstraße 8
  112.                         52388 Nörvenich
  113.                         GERMANY
  114.  
  115.         Phone: (+49)(0)2426/901568
  116.         Fax:   (+49)(0)2426/901569
  117.  
  118.         EMAIL is also available:
  119.         GISBURN@w-specht.rhein-ruhr.de
  120.  
  121.         If you want to send me attachments larger than 1MB (up to 5MB,
  122.         more with my permission):
  123.         Up to April 1998 I'm reachable using this email address, too:
  124.         Reinhold.A.Mainz@KBV.DE
  125.  
  126.         | Please put your name and address in your mails !
  127.         | German mailers should add their phone numbers.
  128.         | See BUGS section above when submitting bug reports.
  129.  
  130.         Sorry, but I can only look once a week for mails.
  131.         If you don't hear something from me within three weeks, please
  132.         send your mail again (but watch about new releases) (problems with
  133.         this email port are caused by reconfigurations, hackers, network
  134.         problems etc.).
  135.  
  136.         The  entire  "DTConvert"  package may  be  noncommercially
  137.         redistributed, provided  that  the package  is always  distributed
  138.         in it's complete  form (including it's documentation).  A small copy
  139.         fee for media costs is okay but any kind of commercial distribution
  140.         is strictly forbidden! Comments  and  suggestions  how  to  improve
  141.         this program  are generally appreciated!
  142.  
  143.         Thanks to Matt Dillon for his DICE, David Junod for this datatypes
  144.         environment and Olaf 'Olsen' Barthel for his help, ideas and some
  145.         text clips from his documentations.
  146.  
  147.     SEE ALSO
  148.  
  149.